home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / graphics / gifexe44.zip / GIFEXE.DOC < prev    next >
Text File  |  1994-03-16  |  21KB  |  508 lines
  1.  
  2.   
  3.  
  4.                            G I F E X E 
  5.  
  6.                            Version 4.4
  7.                           Mar. 15, 1994
  8.       
  9.           A Self-Displayer and Slideshow Program for Your        
  10.                         GIF(tm) Pictures 
  11.             Copyright 1990,1994 Synergrafix Consulting 
  12.                        All right reserved.  
  13.     
  14.      GIFEXE is produced by: 
  15.  
  16.            Steve Enns                  Synergrafix Consulting  
  17.         44 Macdermid Cres.    and        44 Macdermid Cres.
  18.           Saskatoon, Sk.                   Saskatoon, Sk.  
  19.           Canada S7J 2R2                   Canada S7J 2R2  
  20.  
  21.      Okay, here's the boring stuff, but don't worry, it's better
  22.      than chewing tinfoil: 
  23.  
  24.  
  25. ACKNOWLEDGEMENTS 
  26.  
  27.      Kudos, thanks, and good karma to John Bridges for the 
  28.      enlightening information and code contained in his VGAKIT 
  29.      package.  Trademarks like GIF(tm) and PC(tm) are held by 
  30.      their respective companies.  
  31.  
  32.  
  33. DISCLAIMER 
  34.  
  35.      The GIFEXE program is provided without warranty of any      
  36.      kind.  The user of the GIFEXE assumes complete              
  37.      responsibility for any and all incidental or consequential  
  38.      damages which may occur during normal or abnormal use of the
  39.      GIFEXE program.  Use the GIFEXE program at your own risk. 
  40.  
  41.  
  42. LICENSE  
  43.   
  44.      The entire GIFEXE package, including the GIFEXE program, 
  45.      documentation, and sample files are Copyright 1990,1994 
  46.      Synergrafix Consulting.  All rights reserved.  The          
  47.      unregistered shareware version of the GIFEXE may be freely 
  48.      distributed to others by any means, as long the following 
  49.      (three) conditions are met: 
  50.  
  51.           1) GIFEXE is distributed in a "package" containing     
  52.           the following files: 
  53.                               GIFEXE.EXE 
  54.                               GIFEXE.DOC 
  55.                               GE-READ.ME
  56.                               ORDER.FRM
  57.                               FILE_ID.DIZ
  58.            
  59.           2) GIFEXE is not distributed as part of any other      
  60.           product, except with specific written permission from 
  61.           the author, Steve Enns.  
  62.  
  63.           3) NO fee of any kind is charged for the GIFEXE        
  64.           package or for the service of providing the package,   
  65.           except Computer Bulletin Board Systems, which may      
  66.           distribute the GIFEXE package even though they may     
  67.           charge a membership or service fee.   
  68.  
  69.      You can use the "shareware" version for as long as you 
  70.      want, even until you're well into your nineties, but you are
  71.      of course encouraged to send us lots of money, too. (I'm 
  72.      struggling to pay for my violin lessons, and Dan needs a new
  73.      fishing rod.)  If you send $8.00 U.S. or more to the "Steve
  74.      Enns" guy above, you will receive a 5.25" disk (3.5"        
  75.      disks are $2.00 extra) with the latest registered version of
  76.      GIFEXE, which has several additional "special effects"
  77.      features, and can make slideshows from an unlimited number of
  78.      GIFs. (See below.)  If you send $23.00 U.S. or more, you    
  79.      will also receive registered versions of the following      
  80.      programs: 
  81.  
  82.           GIFWARP!       Warp, bend stretch your GIFs for 
  83.                          interesting effects. 
  84.  
  85.           GIFCLIP        Clip/crop your GIFs, add text or your 
  86.                          own GIF logo or signature. 
  87.            
  88.           GIFSIZE        Resize all or part of your GIFs.  Shrink
  89.                          an entire screen to the size of an icon.
  90.  
  91.           HCPLAY/HCMAKE  Make 32,768 color (HiColor) FLI-type 
  92.                          Animations from a series of Targa images.
  93.                          No more colour limitations in your 
  94.                          FLI animations.
  95.  
  96.      (These programs are available in licensed SuperVGA versions
  97.      for $8.00 U.S. each, or get all three, and the latest 
  98.      version of GIFEXE for $23.00 U.S. or more.  The registered
  99.      versions may not be distributed to others, or distributed
  100.      with, or as part of any other product. HCPLAY/HCMAKE are
  101.      available for $30.00 U.S.  See ORDER.FRM.) 
  102.  
  103.  
  104. REQUIREMENTS 
  105.  
  106.           GIFEXE requires the following: 
  107.  
  108.                -    PC(tm)/XT(tm)/AT(tm)/386(tm) computer thing 
  109.                -    About 280K of free RAM 
  110.                -    DOS 3.0-6.0 (others untested)
  111.                -    A VGA or SuperVGA card 
  112.                -    Some GIF(tm) pictures.
  113.  
  114.           and optionally: 
  115.  
  116.                -    GIFEXE supports modes like 640x480, 800x600,
  117.             1024x768 with 256 colours on 512K and 1024K
  118.             SuperVGA cards from ATI, Ahead, Cirrus, Chips
  119.             and Technologies, Everex, OAK, Paradise, Trident,
  120.                     Tseng, Video7, Compaq, NCR, Genoa and VESA. 
  121.             S3 and other Windows accelerator cards that
  122.                     have a VESA bios or driver are also supported.
  123.                     VESA is required for some of the special effects. 
  124.  
  125. INSTALLATION 
  126.  
  127.      Copy the GIFEXE program (and this helpful document of 
  128.      course!) to any directory that you want - perhaps with      
  129.      your favourite GIF(tm) viewer somewhere in the DOS          
  130.      path. 
  131.       
  132.  
  133. USAGE 
  134.  
  135.      Syntax for GIFEXE is as follows: 
  136.  
  137.           GIFEXE [?] infilename[.GIF] [outfilename[.EXE]] 
  138.                     /mode=0,1,2..  /autoscale 
  139.  
  140.      to make a single GIF display program, or 
  141.  
  142.           GIFEXE [?] @listfile [outfilename[.EXE]] 
  143.                     /stopkey=n  /cycle=0,1,2,3
  144.  
  145.      to make a slideshow program.  See the GIFLIST example
  146.      list file, and the GIFLIST.BAT batch file.
  147.  
  148.      In addition, the following "special effects" options
  149.      are available in the registered version:
  150.  
  151.             /fadein /fadeout /dissolve  /delay=secs /noclear
  152.             /bouncein /bounceout /slidein=c /slideout=c /pass=str
  153.  
  154.      Generally, the options may be used with GIFEXE when you are
  155.      creating an EXE, or with the EXE that you have already
  156.      created.  When using a list file to make an EXE slideshow,
  157.      the special effects options are placed in the list file. (See
  158.      TUTORIAL below.) Not all options make sense together - only
  159.      one of the "entrance" effect, and one "exit" effect are allowed
  160.      for each image.  (Can't fade, bounce and slide out all at once - yet.)
  161.  
  162.  
  163.      The options are as follows: 
  164.  
  165.      /mode=code     /mode=0        Ordinary 320x200 mode 
  166.                     /mode=1        Low resolution SVGA 
  167.                                         640x400 or 640x350 
  168.                                         depending on your card. 
  169.                     /mode=2        Medium resolution 640x480 
  170.                     /mode=3        High resolution 800x600  
  171.                     /mode=4        Higher resolution 1024x768 
  172.                                         is supported on some 
  173.                                         1024K cards. Try a VESA
  174.                     driver!) 
  175.                     /mode=5        Higher-still resolution 
  176.                     1280x1024 for VESA.
  177.                      
  178.      /autoscale     When this switch is used, the GIF will be 
  179.                     scaled up to fit on the screen if the screen
  180.                     resolution is 2 or more times the resolution
  181.                     of the GIF.  (Just try it with a 320x200 GIF
  182.                     and a 640x480 screen mode.) 
  183.      
  184.  
  185.      When using a list file to make a slideshow:
  186.  
  187.      /cycle=code    /cycle=0       Play the slideshow once,      
  188.                                    forward
  189.                     /cycle=1       Play the slideshow forward,
  190.                                    continuously
  191.                     /cycle=2       Play the slideshow backward,
  192.                                    continuously
  193.                     /cycle=4       Play the slideshow backward,
  194.                                    once
  195.      /stopkey=code  /stopkey=27    Play the show until ESC key   
  196.                                    (ascii 27) is hit. Default.
  197.                     /stopkey=32    Play until spacebar is hit
  198.           
  199.      And the additional "special effects" available in the
  200.      registered version: 
  201.       
  202.      /fadein        Gradually fade in when displaying the GIF.  
  203.                     The screen will start black, and gradually 
  204.                     the pictures will appear as the colors 
  205.                     brighten. 
  206.  
  207.      /fadeout       After the GIF has been displayed, and the  
  208.                     program is going to exit after a keypress, 
  209.                     or a delay (see below) the screen will 
  210.                     gradually fade to black. 
  211.  
  212.      /dissolve      After the GIF has been displayed, and the 
  213.                     program is going to exit, the pixels will 
  214.                     randomly turn black until the entire picture
  215.                     is gone. 
  216.  
  217.      /delay=secs    After the GIF has been displayed, wait "secs"
  218.                     seconds before automatically exiting.  The 
  219.                     program will also exit if a key is pressed 
  220.                     before the time has expired. 
  221.  
  222.      /noclear       The screen will not be cleared when the program
  223.                     exits.  This is useful if you are using GIFEXE
  224.                     to display an image from a program, and want to
  225.                     leave the image on the screen after the user
  226.                     presses the exit key.
  227.  
  228.      /bouncein      "Bounce" the image onto its position on the 
  229.                     screen.  This effect works best with images
  230.                     that are not as tall as the entire screen - 
  231.                     a GIF image that is 100 pixels high works well
  232.                     for ordinary VGA 320x200 mode, for example.
  233.  
  234.      /bounceout     "Bounce" the image off the screen.  See /bouncein
  235.                     above.
  236.  
  237.      /slidein=c     "Slide" the image onto (or off of) the screen.
  238.      /slideout=c    The character "c" is the direction to slide, 
  239.                     either "l" for left, or "r" for right. If both options
  240.                     are used for an image (both slidein and slideout),
  241.                     then the slideout will slide in the opposite direction
  242.                     of the slidein.  The /slide options currently require
  243.                     a VESA card or driver.
  244.  
  245.      /pass=str      Display the image only if the user has the correct
  246.                     password.  The password is specified on the command
  247.                     line when making the EXE file, and the user is prompted
  248.                     for the password when the image is about to be displayed.
  249.                     If the password is not given, or is incorrect, the image
  250.                     will not be displayed.  This allows "secret" pictures 
  251.                     in a slideshow, for example.  (The password applies to
  252.                     only the current picture. If an entire slideshow is to
  253.                     be protected, then each image will have to specify this
  254.                     option in the list file.  See below.)  The passwords
  255.                     are NOT case sensitive - "password" is considered equal
  256.                     to "PassWord".
  257.  
  258.      When using a list file to make a slideshow, the listfile    
  259.      has the following format:
  260.  
  261.           file1[.gif] /fadein /delay=n /fadeout /mode=m /autoscale /pass=steve
  262.           file2[.gif] ...
  263.           .
  264.           .
  265.           .
  266.           filen[.gif] ...
  267.  
  268.      (One GIF filename with the desired display options on each
  269.      line of the file.  The unregistered version is limited to five
  270.      images in a list file.  The registered version should be    
  271.      able to do several thousand, in case you have the disk space
  272.      and inclination to make a 100 Megabyte slideshow.)
  273.  
  274.      In the registered version, the following keys are valid during the
  275.      slideshow:
  276.  
  277.           PageDown        Go to the next image in the slideshow
  278.  
  279.           PageUp        Go back to the last image
  280.  
  281.           Home            Go back to the first image
  282.  
  283.           End            Go to the last image
  284.  
  285.       Numbers 1-9        Go to image number 'n'. '1' is the
  286.                 first image, '2' for the second...
  287.  
  288.      More sophisticated user controls are being considered for future
  289.      versions of GIFEXE.
  290.                                               
  291.  
  292.      For examples of GIFEXE usage, try: 
  293.  
  294.           C> GIFEXE                to see the title screen 
  295.  
  296.           C> GIFEXE ?              to see the help/brag screen 
  297.  
  298.           C> GIFEXE house          to make the .EXE HOUSE.EXE 
  299.                                    from the file HOUSE.GIF   
  300.  
  301.           C> GIFEXE house house2 /autoscale /fadein 
  302.                                    make the .EXE file HOUSE2.EXE,
  303.                                    from the GIF(tm) HOUSE.GIF 
  304.                                    using autoscale and fadein, so
  305.                                    that HOUSE2 will fadein and 
  306.                                    autoscale when run. (/fadein 
  307.                                    available on registered 
  308.                                    versions only.) 
  309.  
  310.           C> GIFEXE house /delay=10  
  311.                                    make an EXE, HOUSE.EXE which 
  312.                                    will display HOUSE.GIF and 
  313.                                    then wait 10 seconds before 
  314.                                    exiting. 
  315.  
  316.           C> GIFEXE @list /cycle=1 /stopkey=32 
  317.                                    make an EXE, LIST.EXE of the GIF
  318.                                    in the listfile LIST, which   
  319.                                    will play in a loop until the
  320.                                    spacebar (ascii 32) is pressed.
  321.                                    The first image will fadein,
  322.                                    wait 2 seconds and then continue
  323.                                    to the next image. The file   
  324.                                    LIST contains:
  325.                          
  326.                                         gif1 /fadein /delay=2
  327.                                         gif2
  328.                                         gif3
  329.                                         gif4
  330.  
  331.           C> GIFEXE secret.gif /pass=pokey
  332.                                    Make SECRET.EXE from SECRET.GIF,
  333.                                    using the password "POKEY". 
  334.  
  335. TUTORIAL 
  336.  
  337.      (Nothin' to it!) 
  338.  
  339.      Try out the following with your favourite GIF(tm) picture: 
  340.  
  341.                C> GIFEXE picturename 
  342.  
  343.      GIFEXE will prduce an EXE program with the name 
  344.      "picturename.EXE"  That's it!   Now just run the program 
  345.      you've just made: 
  346.  
  347.                C> picturename 
  348.  
  349.      The picture will be displayed on your screen in VGA, or in 
  350.      SuperVGA if your computer has SuperVGA, and the picture 
  351.      requires it.  If you want a small (VGA) picture to be 
  352.      displayed in SuperVGA resolution, try: 
  353.  
  354.                C> picturename /mode=2 
  355.  
  356.      to display the picture in medium SuperVGA resolution.  If 
  357.      you have the registered version, you can make an EXE that 
  358.      will "fade in", and "dissolve out": 
  359.  
  360.                C> GIFEXE picturename /fadein /dissolve  
  361.  
  362.      Now when you run picturename, 
  363.  
  364.                C> picturename 
  365.  
  366.      The picture will "fade in", wait for a keypress, and  
  367.      then "dissolve" and the program will exit.  And even if you
  368.      didn't use some options when you created picturename.EXE, 
  369.      you can still use them later.  Try: 
  370.  
  371.                C> picturename /delay=10 /mode=3 
  372.  
  373.      and then the picture will "fade in" using mode 3, wait for 
  374.      10 seconds or a keypress, and then "dissolve" and exit. 
  375.      
  376.      To make an automated slideshow, make the following file
  377.      (GIFSHOW.LST) with your text editor and your own GIF
  378.      filenames:
  379.  
  380.            gifname1 /fadein /delay=2 /fadeout
  381.            gifname2 /delay=2
  382.            gifname3 /delay=2
  383.            gifname4 /delay=2
  384.            gifname5 /delay=2 /fadeout
  385.  
  386.      Now, use the following GIFEXE command:
  387.  
  388.           C> GIFEXE @gifshow.lst /cycle=1
  389.  
  390.      The file GIFSHOW.EXE will be produced, which will display the
  391.      five images in your slideshow, continuously, until the ESC key
  392.      is pressed:
  393.  
  394.           C> gifshow
  395.  
  396.      You can play the show backwards, until the spacebar is hit by
  397.      changing the cycle and stopkey parameters:
  398.  
  399.           C> gifshow /cycle=3 /stopkey=32
  400.  
  401.      If you omitted the /delay parameters in the list file, each
  402.      GIF would be displayed until a key was pressed, or the
  403.      slideshow was aborted with the ESC or /stopkey. 
  404.  
  405.  
  406. HINTS 
  407.  
  408.      - The EXEs produced by GIFEXE are handy for startup screens
  409.      on your computer, or title screens for your programs. 
  410.  
  411.      - Since version 3.0, self-running slideshows of GIFs may be
  412.      produced without using batch files.  If you are using DOS 5.0,
  413.      there is an easy way to make a list file for slideshows:
  414.  
  415.           C> dir /b *.gif > listfile
  416.  
  417.      "listfile" will now contain the names of all the GIFs in the
  418.      current directory.  You can then just add the desired options
  419.      to each line of the "listfile", and the make the slideshow:
  420.  
  421.       C> gifexe @listfile
  422.  
  423.  
  424. ERRORS 
  425.  
  426.      - The following self explanatory error messages may be 
  427.      produced by GIFEXE.  The errors involving the GIF(tm) files
  428.      will generally be due to disk errors or faulty image files. 
  429.      Other errors refer to lack of enough free RAM space, or lack
  430.      of required hardware (VGA). 
  431.  
  432.           Can't initialize VGA graphics! 
  433.           Unexpected EOF reading GIF! 
  434.           Premature end of GIF! 
  435.           Not GIF file! 
  436.           Invalid GIF format 
  437.           Error writing GIF! 
  438.           Buffer allocation failure! 
  439.            
  440.  
  441. NOTES 
  442.  
  443.      - GIFEXE reads both GIF87A standard (the original) and      
  444.      new GIF89A pictures, although most of the extensions in the
  445.      new GIF89A standard like (silly) text windows are ignored. 
  446.      The last image in multi-image GIFs will be the one displayed
  447.      by GIFEXE. 
  448.   
  449.  
  450. HISTORY 
  451.  
  452.      - Version 1.0 Completed June.1 1991 
  453.       
  454.      - Version 1.2 Completed Sep.15 1991 
  455.           Some additional cards now supported.  1024x768x256 now
  456.           supported on some 1024K cards. 
  457.  
  458.      - Version 2.0 Completed Sep.20 1991 
  459.           Registered version introduced with /fadein /fadeout 
  460.           /dissolve /delay options.  /autoscale option           
  461.           added to both versions. 
  462.  
  463.      - Version 3.0 Completed Oct.1 1991
  464.           Multiple GIF EXE slideshows may now be produced.
  465.  
  466.      - Version 3.1 Completed Oct.4 1991
  467.           Ahhhhhh!!!!  Fixed INCREDIBLY STUPID bug that would cause
  468.           GIFEXE to abort if the picture was too big for the
  469.           screen.  Fixed bug that wouldn't allow full pathnames for
  470.           input files on the command line.
  471.  
  472.      - Version 3.2 Completed Feb.14 1993
  473.           Added /noclear option to registered version.
  474.  
  475.      - Version 4.0 Completed May 20 1993
  476.       More graphics support for newer graphics hardware.  Much
  477.       better VESA support.  (If GIFEXE dosen't want to do high-
  478.       resolution on your video card, try loading a VESA driver!)
  479.       S3 and other Windows accelerator cards which support VESA
  480.       are now supported.
  481.       
  482.           New /bouncein,  /bounceout and /pass options.
  483.  
  484.      - Version 4.1 Completed June 9 1993
  485.           Ahhhhhhhhhhhhhhh!!!!!!! Noooooooo!!!!  Fixed second
  486.           INCREDIBLY STUPID bug in the VESA support for modes
  487.           greater than 640x480.
  488.           
  489.           Addition of 1280x1024 support for VESA.
  490.  
  491.      - Version 4.2 Completed Feb. 27 1994
  492.           Additional VESA compatibility added for really weird
  493.           video cards... 
  494.           Added checks for blank lines in slideshow list files
  495.           that were screwing up some people...
  496.           Getting ready for more special effects options!
  497.  
  498.      - Version 4.3 Completed Mar. 7 1994
  499.           Added some key controls to slideshows in the registered 
  500.           version. The user can now move backward and foreward
  501.           through the slideshow.  (See the end of the USAGE section.)
  502.  
  503.      - Version 4.4 Completed Mar. 15 1994
  504.           Added /slidein /slideout effects to registered version
  505.           (which currently require VESA.)
  506.           
  507.  
  508.